home *** CD-ROM | disk | FTP | other *** search
/ Mac Magazin/MacEasy 8 / Mac Magazin and MacEasy Magazine CD - Issue 08.iso / Sharewarebibliothek / Applikationen / Survival 6.0.3 ƒ / Survival Last Changes.txt < prev    next >
Text File  |  1995-03-20  |  13KB  |  231 lines

  1. SURVIVAL 6.0.2 Last Changes
  2.  
  3. •Median of survival with 95% IC is now estimated and printed for the different groups.
  4.  
  5. •Now if you double-clickin on a Text File or a Binary File created by the program the
  6. application is launched an the selected file is automatically loaded and opened.
  7.  
  8. •If you try to select a variable that has the same value than the Status variable or
  9. the Time variable you get three beeps and the corresponding box flashes to warn you.
  10.  
  11. • If you press the Option key down while selecting the Help item from the Apple menu,
  12. a full description of the available macro commands is displayed in the Help window,
  13. which may be printed with the Print option of the File Menu.If you don't press the
  14. option key a Help window with a general description about the program and the different
  15. Menu options is displayed.The Help id displayed in styled Text.
  16.  
  17. • If the Option key is pressed while launching the application, a macro file is loaded
  18. in memory and the macro located in second position in the macro menu is automatically
  19. executed. The first position is left to allow the user to define a function for time-
  20. dependent survival analysis. The file should be named 'Survival Macros' and must be
  21. located in the same folder than the application. If you don't press the Option key
  22. the file is just loaded to be used from the Macros Menu.
  23. This option allows to link Survival with your current database for fully automated
  24. survival analysis.
  25.  
  26. • The MAKEBINS macro now lists the number of cases in each bin.
  27.  
  28. • An Overlay Plot option has been added to the SURVIVAL CHART menu so you can show in a single
  29. plot the baseline survival function against different levels of the covariates, for comparative
  30. and illustrative purposes. If you press the Option key down while slecting this option the
  31. plots are displayed with dashed lines to identify the groups insted of colors.Usee the Adjust
  32. Bit Mapp from the Page Setup option of your printer (if available)
  33.  
  34. • Now the legends for both numerical and graphical Plots may be printed in SPANISH if
  35. you select the OUTPUT IN SPANISH item from the Outoput Options menu (welcome folks).
  36. Menus, Macro commands, Dialog boxs and warning messages are not changed (sorry folks, but
  37. have you ever tried to translate the menu legends of an English program into Spanish so that
  38. the final product becomes as short as understandable for average people (try to translate into
  39. Spanish, for example, the english word 'Hyphenating',. I've read something like 'guioneando'
  40. which is an aberration).
  41.  
  42.  
  43. • If the CONTROL key is pressed while selecting a covariate in the variable window of
  44. the DEFINE MODEL dialog a (c) sign appears in the rightmost side of the variable in the model
  45. window.
  46. This ENABLES the internal transformation of categorical variables into K-1 INDICATOR or
  47. DEVIATION variables, where K is the max number of categories of the selected variable. If you
  48. want to use DEVIATION coding, uncheck the 'USE INDICATOR VARIABLES' box.
  49. You may obtain the same results with the TRANSFORM option of the MODEL menu  but you have to
  50. manuallay include the different variables in the model.
  51. On the output window the coefficientes are labeled as VAR1-1, VAR1-2,  etc. or as NAME-1,
  52. NAME-2, NAME-3 ... etc if you checked the LABEL VARIABLES option.
  53.  
  54. *** VERY IMPORTANT
  55.     -------------- 
  56. All the variables selected as categorical (Control Key Down) must be done in ASCENDING ORDER.
  57. If you try to select,for example, variable 6 if you previously selected a variable whose
  58. column number es equal or less than variable 6, the program beeps, the model window will be
  59. CLEARED and You'll have to start the variables selection again. This rule is also applied when
  60. in a model you combine categoricial with non-categorical variables. Non-categorical variables
  61. alone may be selected in any order ***
  62.  
  63.  
  64. I WAS COMPELLED to add this option to my program because a common error I observed in Survival analysis is the use of categorical variables 'as is' as covariates in regression models.
  65. You should be aware that if you use this type of variables you are making 'a priori' assumption
  66. about a lineal dependence of the hazard function with the different levels of the categorical
  67. variable, a fact that most of the times is WRONG (I repeat WRONG), unless otherwise 
  68. demonstrated. 
  69. If you use the INDICATOR coding scheme you compare the effect of a particular category with
  70. some other category taken as reference (the first one in our case). The value and sign of the
  71. new coefficients will tell you if that particular category increases (positive values)
  72. or decreases (negative values) the chance of survival.The value of the coefficient for the
  73. reference category (first one) is 0 and is not displayed. 
  74. If you use the DEVIATION coding scheme you compare a particular category with the average
  75. effect for all categories. The coefficient for the reference category (first) is calculated as
  76. the negative value of the sum of all coefficients for that category.
  77. Use the TEST OF HYPOTHESIS option to assess the joint effect upon hazard of the differente categories of the transformed variables or the different combinations ov covariates you
  78. consider significant in your particular model. 
  79.  
  80. ** YOU CAN'T IMAGINE HOW MUCH YOUR RESULTS AND CONCLUSIONS MAY CHANGE IF YOU USE AN
  81. INAPPROPRIATE CODING OF YOUR VARIABLES WITH COX'S REGRESSION ANALYSIS **
  82.  
  83. HERE ARE MY RECOMENDATIONS:
  84.  
  85. 1) USE BINARY VARIABLES (0,1) WHENEVER POSSIBLE.
  86. 2) NEVER USE CATEGORICAL VARIABLES AS COVARIATES. TRANSFORM THEM INTO INDICATOR OR DEVIATION
  87.    VARIABLES WITH THE ABOVE OPTIONS.
  88. 3) IF YOU USE NUMERICAL VARIABLES MAKE AN ALTERNATIVE ANALYSIS BY TRANSFORMING THEM INTO
  89.    DIFFERENT GROUPS OR  CATEGORIES WITH THE 'MAKEBINS' MACRO (You'll love it) AND THEN
  90.    TRANSFORMING THE CATEGORIES INTO INDICATOR OR DEVIATION VARIABLES. (Many times the effect
  91.    of numerical variables upon the chance of survival is only significant for a limited
  92.    interval of values, for example, between 60-70 years but not below or above that AGES.
  93.    If you obtain a significant P value for a numerical variable and you don't explore this
  94.    possibility you would draw the conclusion, otherwise wrong, that the chance of survival
  95.    decreases for increasing age values).
  96.  
  97. 4) I PERSONALLY PREFER THE DEVIATION CODING SCHEME.
  98.  
  99. 5) NEVER BECOME A SLAVE OF THE 'P < 0.05' EXPRESSION OR LET IT BE A SUBSTITUTE OF YOUR NEURONS
  100.    OR THE COMMON SENSE.
  101.  
  102. 6) MODELLING THE RISK IS THE BEST CHALLANGE AND THE BEST WAY TO TEST YOUR KNOWLEDGE
  103.    ON A PARTICULAR CLINICAL INVESTIGATION PROBLEM. USE THE LIKELIHOOD RATIO TEST TO ASSESS
  104.    IF A GIVEN COVARIATE IN A MODEL, WITH NO SIGNIFICANT P VALUE, SHOULD BE LEFT OR REMOVED
  105.    FROM THE MODEL.
  106.  
  107. 7) STICK ALWAYS TO THE BASIC PRINCIPLE OF SCIENCE: THE 'PARSIMONY' AND TRY TO DESCRIBE YOUR
  108.    PROBLEM WITH SIMPLE MODELS AND USING THE LEAST POSSIBLE NUMBER OF VARIABLES. 
  109.  
  110.  
  111. NEW MACROS :
  112.  
  113. • SURVPLOT; activates the plot of both Kaplan-Meier and Model Survival function. It
  114.      must be used before the ESTIMATE macro command. This macro substitutes the
  115.      GRAPHPLOT('true','false') command of previous versions.
  116.  
  117. • LOGPLOT; activates the plot of Log -(Log) of Survival function, which is used for
  118.      testing the proportionality assumption.It must be used after the ESTIMATE macro
  119.      command
  120.  
  121. • INTPLOT(number); actives the plot of the Confidence Intervals for the current
  122.      survival function. It must be used after the ESTIMATE command. 'number' is 1 for
  123.      95% CI and 2 for 99% CI.
  124.  
  125. • RESPLOT; activates the plot of the Cumulative Function for Residuals, which is
  126.      used to Test the goodness of fit of data to model.It must also be used after the
  127.      ESTIMATE macro command.
  128.  
  129. • SAVEPICT('name') saves the picture displayed in the active plot window to disk
  130.      in the same folder than the application. This command should be used after the
  131.      SURVPLOT, INTPLOT, LOGPLOT and RESPLOT macro commands, if you pretend to make
  132.      different survival analysis with a single macro and want to save the graphical
  133.      output.This macro also closes the active Plot window after saving to the disk. 
  134.      If you use an empty string as the 'name' argument, until you start a new analysis
  135.      the graphic plots ar saved as Kaplan-Meier.PICTn, Model.PICTn, LogLog.PICTn,
  136.      Intervals.PICTn and Residuals.PICTn, where 'n' is automatically increased for
  137.      each saved file of the same graphic type.
  138.      Use a Path if you want the pictures saved in a different folder
  139.      This option is not available with the Macro Command submenu.
  140.  
  141. • RUNMACRO(number); excutes the macro located in the position 'number' in the
  142.      Macro Menu. Useful for linking different macros in complex automated survival
  143.      analysis. Read carefully the macros in the 'Survival Macros' to learn how to
  144.      use these commands.
  145.  
  146. • SORTBY(column1,column2); sorts data array in ascending order by 'column1' and
  147.      'column2'. If you put a zero for the value in 'column2' the data array is only
  148.      sorted by the ascending order of values in 'column1'.
  149.  
  150. • CLEAR; clears the active output window. This option is not available with the
  151.      Macro Command submenu for System versions less than 7.xx.
  152.  
  153. • FIXDATA; makes permanente the changes in data array. You need to reload your data
  154.      file if you want your original data back.
  155.  
  156. • CATEGORIES(Var1,var2,..option). Indentifies the categorical variables in the data array
  157. included in the model that have to be transformed into DEVIATION (option = 0) or INDICATOR
  158. (option = 1) variables.
  159.  
  160. STATISTICAL MACROS:
  161.  
  162. This macros help a lot for an on line assessment of summary statistics of our
  163. data array in memory. Using these macros with standar Pascal procedures you may
  164. even compute other statistical Tests and compute the exact probability associated
  165. to the test value. ¿ DO YOU DARE ? 
  166.  
  167.  
  168. •STAT(var,var, ...) computes descriptive statistics (average, SD, SE, Min,Max
  169.     and Range) for the specified 'vars'. If you use a minus sign as argument (-) the
  170.     statistics for all variables in the active data array are computed.
  171.  
  172. •CHITEST(var1,var2); computes a Chi-Square Test for categories in the 'var1' column
  173.     of the data array by the categories in the 'var2'column of the data array.
  174.     Results are presented in a contingency table where the rows are the max number of
  175.     categories in 'var1' and the columns the max number of categories in 'var2'
  176.     The maximum number of categories is seven and the categories should be
  177.     numerated from 1 to N categories.
  178.  
  179. •TTEST(var1,var2,[Var3]); computes a Student T-Test betwen Var1 and Var2. If you
  180. use the same value for Var1 and Var2 and use Var3, which is optional, a T-Test is
  181. computed for the groups in Var3. The number of groups must be two (use the RECODE or
  182. COMPUTE MACRO if necessary) otherwise you'll get an error message.
  183.  
  184.  
  185. •CHIPROB(chi,df); computes the exact  P value for ChiSquare distribution 'chi' with
  186.     'df' degrees of freedom.
  187.  
  188. •FPROB(F,df1,df2); computes the exact  P value for F distribution 'F' with 'df1' and
  189.     'df2' degrees of freedom.
  190.  
  191. •NORMPROB(Z); computes the exact  P value for Normal distribution 'Z'.
  192.  
  193. •TPROB(T,df); computes the exact  P value for Student T distribution 'T' with
  194.     'df' degrees of freedom.
  195.  
  196. You may acces the numerical results of these Tests for further processing within
  197. a standard pascal procedure or macro with the TEMP[] Token as follows:
  198.  
  199. ====================================================================================
  200.                   Temp[1]     Temp[2]    Temp[3]   Temp[4]   Temp[5]   Temp[6]
  201.  
  202. -CHITEST          Chi-Value   P-value      df         -          -         -
  203. -TTEST                  T-Value     P-Value      df
  204. -CHIPROB          Chi-Value   P-Value      df         -          -         -
  205. -NORMPROB         Z-Value     P-Value      -          -          -         -
  206. -TPROB            T-Value     P-Value      df         -          -         -
  207. -FPROB            F-Value     P-Value      df1        df2        -         -
  208. -STAT(x)          Mean(x)     SD(x)        SE(x)    Min(x)    Max(x)    Range(x)
  209. -----------------------------------------------------------------------------------
  210. Example
  211.  
  212.     if Temp[2] < 0.05 the RUNMACRO(2) else EXIT;
  213.  
  214.  
  215.  
  216.  --- Bug corrections ----
  217.  
  218. - a bug that prevented to save the model when the number of selected vars was ONE has been
  219.  fixed
  220. - a bug that bombed when trying to save the Data array as 'Application File' under system 6.7x
  221.  has been fixed.
  222.  
  223.  
  224.  
  225.     
  226.   
  227.  Please report any problem or bug you detect to:
  228.  
  229.   Manuel Urrutia Avisrror
  230.   urrutia@gugu.usal.es 
  231.